.. _cedioOneF_Get:

cedioOneF_Get
=============
-------------


SYNOPSIS
--------


.. code-block:: none

  VT_I4 cedioOneF_Get(
    VT_I4 Channel,
    VT_I4 CutoffTime_us,
    VT_PI4 State
  )



DESCRIPTION
-----------


- 단일 채널을 대상으로 노이즈 필터 기능에 대응 되는 디지털 입력 채널 상태를 확인합니다. 이 상태는 cedioLogicOne_Set 함수를 통해 설정된 디지털 입력 로직(Digital Input Logic)이 적용됩니다.
- 이 함수에서 전달되는 매개변수 중 ‘CutoffTime_us’는 입력 신호 유지 시간(Signal Width)을 의미합니다. 이 함수를 통해 확인되는 디지털 입력 채널은 입력 신호 유지 시간 이상의 신호가 확인되어야만합니다. 원하지 않는 신호(Noise)나 일정 시간 이상의 펄스 입력(Pulse Input)을 확인할 때 매우 유용한 상태 확인 함수입니다..



PARAMETER
---------


- Channel : 채널 번호. 통합 채널로 관리되는 채널 번호를 의미하며, 상수 값으로 0 (Zero Based). 이상, (최대 통합 채널수 - 1) 이하의 값을 채널 번호로 설정할 수 있습니다. 

- CutoffTime_us : 디지털 입력 신호 유지 시간을 마이크로 초(us) 단위로 설정합니다. 

- State :  단일 채널에 대한 디지털 입력 상태를 반환합니다. 하며, cedioMulti_Put 함수에서는 입력 또는 출력 상태를 설정합니다. . 



+--------------+-------------+
| Value        | Meaning     |
+==============+=============+
| 0 (CE_FALSE) | Input Mode  |
+--------------+-------------+
| 1 (CE_TRUE)  | Output Mode |
+--------------+-------------+




RETURN VALUE
------------

+----------------+-------------------------------------------------------+
| Value          | Meaning                                               |
+================+=======================================================+
| 음수           | 수행 실패. 자세한 내용은 '에러 처리' 편을 참고합니다. |
+----------------+-------------------------------------------------------+
| 0 (ceERR_NONE) | 수행 성공                                             |
+----------------+-------------------------------------------------------+


EXAMPLE
`````````````

.. code-block:: cpp
 :linenos:

 C/C++
 #include “ceSDK.h”
 #include “ceSDKDef.h”
 
 /* 0 번 채널은 디지털 출력 채널, 1 번 채널은 디지털 입력 채널이라 가정합니다.
 0 번 채널을 통해 일정 시간의 Pulse 출력을 내고,
 1 번 입력 채널의 노이즈 필터 기능을 통해 입력 상태를 확인합니다. */
 long nDoChNo = 0; // 디지털 출력 채널 번호 설정
 long nDiChNo = 1; // 디지털 입력 채널 번호 설정
 long nDiState; // 디지털 입력 상태 정보
 long nRetVal;
 // 출력 채널의 로직을 B 접점으로 설정합니다
 cedioLogicOne_Set ( nDoChNo, cemLOGIC_B );
 // 10usec 동안 단일 펄스 출력을 발생합니다.
 nRetVal = cedioPulseOne ( nDoChNo, // 채널 번호
 CE_TRUE, // B 접점일 경우 Active High 상태가 됩니다.
 10, // 펄스 출력 시간. 10usec
 CE_FALSE // 펄스 출력 후 바로 반환
 );
 if ( nRetVal == ceERR_NONE )
 {
 // 입력 채널의 노이즈 필터 기능을 활성화 하고,
 // 20 usec 입력 신호 유지 시간을 설정하여 입력 상태를 확인합니다.
 cedioOneF_Get ( nDiChNo, 20, &nDiState );
 /* 10usec 펄스가 입력되어 노이즈 필터 기능에 의해 20usec 이하의 신호는 ON 신호로 인식하지 않습니다. */
}